feat(ui): [FEATURE BRANCH] Guarantee consuming-app global CSS can't distort Bible components - Shadow DOM - #348

* feat(ui): validate shadow DOM dialog top layer

* docs(ui): separate shadow DOM rollout plan

* refactor(ui): simplify shadow dialog coordination

* test(ui): prove shadow dialog escapes clipping

* refactor(ui): tighten shadow dialog portal behavior

---------

Co-authored-by: abharms <aharms@works24.com>

…sion/platform-sdk-react into journey-to-the-shadow-dom

* fix(ui): harden Shadow DOM CSS isolation

* test(ui): cover InputGroup SDK radius token

* test(ui): align input group radius assertion

---------

Co-authored-by: abharms <aharms@works24.com>

* fix(ui): route verse actions through shadow portals

* style(ui): use logical overflow in shadow story

* fix(ui): address verse action popover review feedback

---------

Co-authored-by: abharms <aharms@works24.com>

…journey-to-the-shadow-dom

* test(ui): validate shadow consumer compatibility (YPE-5436)

* test(ui): strengthen shadow compatibility evidence (YPE-5436)

* test(ui): await shadow content rendering (YPE-5436)

* docs(ui): qualify shadow automation guidance (YPE-5436)

* docs(ui): clarify shadow compatibility stories (YPE-5436)

* docs(ui): tighten shadow rollout research handoff (YPE-5436)

* test(ui): remove instructional copy assertions

* test(ui): address YPE-5436 review feedback

---------

Co-authored-by: abharms <aharms@works24.com>

)

* test(ui): prove nested overlays through the production shadow seam

Exercise YPE-5355 nested and concurrent overlay scenarios against the real ShadowRootHost + Radix path, without adding an ownership registry.

* fix(ui): restore shadow dialog focus after a rapid reopen

The production seam handled nested and concurrent overlays without a new ownership registry. Rapid reopen during exit captured the outgoing overlay as the restore target; skip portal-container nodes and fall back to the last wrapper control.

* test(ui): add static Storybook frames for the production overlay seam

Leave the ticket scenarios on screen so the production VerseActionPopover, permission dialog, nested popover, and independent overlays can be inspected without racing the play function.

* test(ui): finalize YPE-5355 overlay evidence

* docs: keep overlay proof evidence-only

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: abharms <aharms@works24.com>

* fix(ui): address shadow DOM review regressions

* test(ui): strengthen touch interaction coverage

* test(ui): wait for placement before measuring touch reanchoring

---------

Co-authored-by: abharms <aharms@works24.com>

* fix(ui): enforce custom property contract

* refactor(ui): clarify CSS contract validation

* docs(ui): clarify completed CSS audit step

* test(ui): strengthen custom property contract coverage

* refactor(ui): simplify custom property exceptions

* test(ui): prove shadow DOM hydration contract

* test(ui): strengthen shadow DOM hydration evidence

* docs: tighten shadow DOM hydration decision

* test(ui): prove iframe shadow styles apply

* test(ui): validate realistic Shadow DOM usage

* test(ui): prove Strict Mode effect replay

* fix(ui): make Strict Mode story environment-aware

Amp-Thread-ID: https://ampcode.com/threads/T-01a0b034-6762-73c1-b2a3-d05d405d0479

* fix(ci): unblock journey pull requests

* fix(ci): scope stacked release previews

* test(ci): exercise stacked release preview behavior

* test(ui): consolidate Storybook DOM wait helpers

* test(ui): preserve shadow root wait timing

* test(ui): mock font stylesheet in Storybook

* test(ui): add cross-browser shadow DOM coverage

* test(ui): stabilize Firefox story readiness

* fix(ci): stabilize shadow browser jobs

* test(ui): make overlay exit ordering deterministic

* test(ui): await Storybook assertions

* fix(ci): avoid Firefox matcher teardown rejections

* test(ui): await shadow browser assertions

* test(ui): stabilize shadow browser timing

* test(ui): consume shadow story wait promises

* test(ui): avoid matcher promises in shadow stories

* fix(ui): handle language sync rejections

* test(ui): log browser unhandled rejection details

* test(ui): ignore expected font load events in firefox

* test(ui): filter firefox stylesheet load events

* test(ui): ignore browser events in lifecycle assertion

* test(ui): narrow font rejection filter

* test(ui): harden shadow DOM cross-browser evidence

* fix(ui): preserve shadow picker spacing in Safari

* fix(ui): preserve document-root spacing in Safari

* test(ui): cover spacing fixes cross-browser

* test(ui): reuse Storybook wait helper

* docs(ui): define Shadow DOM rollout policy

Reconcile YPE-5356 research into a coordinated package-wide rollout plan and focused implementation tickets.

* docs(ui): simplify rollout policy ownership

Keep the production policy authoritative and remove stale or overly broad dependency language found during the YPE-5356 simplification audit.

* docs(ui): clarify pending rollout evidence

Complete the public provider inventory and distinguish YPE-5946 branch results from browser coverage already present on YPE-5356.

* docs(ui): reconcile Shadow DOM rollout evidence

* docs(ui): keep rollout policy authoritative

* docs(ui): correct rollout compatibility status

…-dom

# Conflicts:
#	.github/workflows/major-release-signoff.yml

* feat(ui): harden shadow boundary foundation

Refs: YPE-5947

* test(ui): consolidate shadow stylesheet failures

Refs: YPE-5947

* test(ui): prove shadow recovery across documents

Refs: YPE-5947

* test(ui): assert document-scoped shadow stylesheet

* feat(ui): isolate Bible pickers in Shadow DOM (YPE-5949)

* test(ui): deduplicate picker portal evidence (YPE-5949)

* test(ui): strengthen picker boundary evidence (YPE-5949)

* test(ui): stabilize chapter picker search journey (YPE-5949)

* test(ui): keep picker search proof deterministic (YPE-5949)

* test(ui): await picker data before search (YPE-5949)

* test(ui): isolate picker journey data (YPE-5949)

* test(ui): preserve picker initial state coverage (YPE-5949)

* test(ui): avoid dynamic picker height assertion (YPE-5949)

* docs(ui): align picker rollout records (YPE-5949)

* docs(ui): include reader search in Shadow DOM rollout

* docs(ui): refresh Shadow DOM evidence guidance

* feat(ui): isolate leaf components (YPE-5948)

* test(ui): close leaf isolation review gaps

* chore(ui): account for leaf isolation bundle cost

* fix(ui): preserve leaf host and theme contracts

* fix(ui): preserve explicit shadow themes

* chore(ui): allow bundle measurement variance

* fix(ui): preserve isolated leaf borders

* docs(ui): tighten shadow rollout guidance

* test(ui): remove redundant avatar story plays

* fix(ui): inherit provider theme in footnotes

* fix(ui): address shadow isolation review feedback

The replacement-failure recovery test passed even when the SDK sheet was
cached before replaceSync, which would leave later roots unstyled. Assert
that the recovered root adopts a populated sheet.

Also explain why the picker search inputs use onInput and why two picker
stories clear search with fireEvent.input inside shadow roots.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* feat(ui): isolate leaf components (YPE-5948)

* test(ui): close leaf isolation review gaps

* chore(ui): account for leaf isolation bundle cost

* fix(ui): preserve leaf host and theme contracts

* fix(ui): preserve explicit shadow themes

* chore(ui): allow bundle measurement variance

* fix(ui): preserve isolated leaf borders

* docs(ui): tighten shadow rollout guidance

* test(ui): remove redundant avatar story plays

* fix(ui): inherit provider theme in footnotes

* fix(ui): address shadow isolation review feedback

* feat(ui): isolate theme settings content (YPE-5994)

* refactor(ui): simplify theme settings evidence (YPE-5994)

* test(ui): close theme settings review gaps (YPE-5994)

* fix(ui): preserve constrained settings layout (YPE-5994)

* fix(ui): finalize settings host strategy (YPE-5994)

* fix(ui): address shadow layout review findings

* test(ui): make future reader boundary test falsifiable (YPE-5994)

Render the reader directly in the simulated boundary so the test fails
if the Toolbar stops reusing it for settings.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(ui): preserve popover keyboard navigation across shadow roots

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>